Asistente para adaptar DB2 de Approach a Web
Bienvenido al Asistente para adaptar DB2 de Approach a Web. Con este Asistente podrá trasladar a Web sus aplicaciones de Approach/DB2 o adaptarlas para Web, utilizando la tecnología DB2WWW de IBM.
¿Qué es el Asistente para adaptar DB2 de Approach a Web?
Asistente para adaptar DB2 de Approach a Web permite crear aplicaciones para Internet a partir de aplicaciones de Approach/DB2. Permite elegir una aplicación de Approach nueva o existente realizada en un servidor de bases de datos DB2 de IBM y adaptarla a Web mediante el Asistente para adaptar DB2 de Approach a Web.
Primero cree visualmente su aplicación de Approach utilizando un servidor de bases de datos DB2 de IBM. A continuación, utilice el Asistente para adaptar DB2 de Approach a Web para "convertir" la aplicación de Approach en una aplicación IBM DB2WWW o Net.Data. El Asistente, partiendo de los formularios e informes realizados en DB2, creará formularios HTML mediante la tecnología DB2WWW de IBM o Net.Data. El resultado final será una aplicación para Internet utilizando un servidor para bases de datos DB2 de IBM.
Requisitos de software
- Lotus Approach 97
- IBM DB2 CAE (únicamente si Approach y DB2 se ejecutan en equipos diferentes)
- IBM DB2 CAE- IBM DB2WWW v1 o Net.Data
- Servidor HTTP
- Servidor DB2 de IBM
Utilización del Asistente para adaptar DB2 de Approach a Web
Paso 1. Selección de la aplicación de Approach a utilizar para la consulta.
El Asistente mostrará una lista de todas las aplicaciones que estén abiertas en Approach. También puede elegir otras aplicaciones seleccionando "Abrir".
Paso 2. Selección del formulario de entrada y del informe de salida.
El Asistente mostrará una lista de todos los formularios e informes disponibles en la aplicación seleccionada.
Seleccione un formulario. El formulario se mostrará como un formulario de consulta HTML.
Seleccione un informe en el que visualizar el resultado de la solicitud. Si selecciona "Informe como formulario de entrada", el informe de Approach que seleccione se utilizará tanto para el formulario de consulta como para el informe resultante.
Haga clic en "Seleccionar fondo para Web" para seleccionar la imagen a utilizar como fondo para el formulario HTML y el informe HTML.
Nota: Si instala el Asistente para adaptar a Web mediante la instalación personalizada, las imágenes se instalarán en una subcarpeta dentro de la carpeta de Smartmasters de Approach. Deberá mover dichas imágenes hasta la carpeta adecuada del servidor Web.
Si la opción "Informe como formulario de entrada" está seleccionada, el informe se utilizará como consulta HTML y como informe HTML.
Paso 3. Acceso
Para definir un ID de usuario y una contraseña a utilizar por todo usuario que desee acceder al formulario de entrada HTML y registrarse en DB2, seleccione "Utilizar siempre" y especifique un ID de usuario y una contraseña. Si desea que se solicite al usuario su identificación o contraseña, seleccione "Solicitar al usuario".
Indique un nombre de base de datos válido (imprescindible). El Asistente para adaptar DB2 de Approach a Web no continuará hasta que lo haya hecho.
Especifique un nombre para el archivo de macros de DB2WWW. El Asistente creará el archivo en la ubicación especificada y con el nombre especificado.
Paso 4. Opciones de SQL
A continuación, debe configurar varias opciones de SQL.
Visualización SQL
Define si debe mostrarse al usuario la sentencia de SQL que se genera y se envía a DB2. Seleccione una de las siguientes opciones:
Solicitar al usuario - Pregunta a los usuarios si desean visualizar la sentencia de SQL en el informe.
Siempre activada - Muestra siempre la sentencia de SQL en el informe.
Siempre desactivada - Nunca muestra la sentencia de SQL en el informe.
Nota: Si dispone de la primera versión de DB2WWW, se ignorará esta opción y la sentencia de SQL aparecerá siempre. Actualice a la última versión de DB2WWW o Net.Data.
Tipo de búsqueda
Define que tipo de búsqueda que se realizará. Seleccione una de las siguientes opciones:
Solicitar al usuario - Pregunta a los usuarios el tipo de búsqueda en el formulario de consulta.
Y - El tipo de búsqueda es siempre Y.
O - El tipo de búsqueda es siempre O.
Definir tabla de mensajes de error/advertencia
Asigna los códigos de error de SQL que devuelve el servidor DB2 con sus mensajes de error. Los mensajes de esta tabla deben estar en formato HTML.
Puede utilizar la tabla de mensajes de error/advertencia para que el archivo de macros generado "busque" los códigos de SQL devueltos como resultado de una consulta. Si se produce una advertencia o error de SQL como resultado de una consulta del usuario, el archivo de macros generado puede realizar un proceso alternativo. Por ejemplo, puede especificar sus propios mensajes de error/advertencia en lugar de utilizar los mensajes predeterminados.
Para agregar su propia correspondencia de mensajes de error/advertencia, especifique el código de SQL del mensaje de error/advertencia que desee buscar. Observe que debe especificar el código de SQL y no el número de mensaje de error de SQL. Por ejemplo, para buscar la condición "Nombre de usuario y/o contraseña incorrecta", debe especificar el código de SQL "-1403" y no el número del mensaje de error "SQL01403N". Seguidamente, especifique el mensaje que desea que aparezca cuando se produzca el código de SQL. El texto del mensaje de error puede incluir cualquier HTML válido. Por último, para códigos de SQL positivos, dispone de la opción "Continuar". Si se especifica esta opción, se mostrará el resto de la página de informe HTML a continuación del mensaje. De este modo, si un informe cuenta con un encabezado o un pie de página que desee que aparezca junto con su mensaje de error, marque la casilla "Continuar". Observe que "Continuar" no es una opción válida para códigos de SQL negativos. Los códigos de SQL negativos nunca pueden "continuar" y, por lo tanto, no se mostrará ninguna parte del informe HTML.
En la parte inferior de la tabla, tiene la opción de especificar un mensaje de error predeterminado. Si se produce un error o una advertencia que no coincida con ninguna entrada de la tabla de mensajes de error/advertencia, se utilizará el mensaje de error predeterminado. En caso de que no se haya especificado ningún mensaje de error predeterminado, se mostrará un mensaje de error de DB2.
Número máximo de filas a devolver
Define el número máximo de filas que DB2 devolverá para el informe.
Especifique el número máximo de filas a devolver de la consulta DB2. El valor 0 hará que se devuelvan todas las filas.
Paso 5. Opciones de WWW
Ruta de las imágenes
La ruta de acceso de las imágenes es la unidad:\carpeta del servidor HTML en la que están almacenadas las imágenes.
Especifique la ruta de acceso de la carpeta de imágenes en el servidor HTML.
Subcarpeta de macros
Esta ruta de acceso se refiere a la subcarpeta situada en la carpeta de macros de DB2WWW en la que se almacenan los archivos de macros. Esta información es opcional. De forma predeterminada, es la carpeta raíz de macros de DB2WWW. El Asistente no creará el archivo de macros en esta carpeta a no ser que el usuario especifique una unidad asignada a dicha carpeta. El usuario debería situar los archivos de macro (*.d2w) en la carpeta de macros.
Nombre del ejecutable
Es la ruta de acceso y el nombre del archivo ejecutable de DB2WWW (p.ej. /cgi-bin/DB2WWW.EXE)
Especifique la carpeta en la que se encuentre el archivo ejecutable de DB2WWW.
Conversión mayúsc./minúsc.:
No convertir - Se respetará la combinación de mayúsculas y minúsculas especificada por el usuario en el formulario de entrada HTML.
Minúsculas - Todos los datos especificados por el usuario en el formulario de entrada HTML se convertirán a minúsculas antes de presentar la consulta.
Mayúsculas - Todos los datos especificados por el usuario en el formulario de entrada HTML se convertirán a mayúsculas antes de presentar la consulta.
Opciones del formulario:
Enviar - Esta opción envía el contenido del formulario de consulta al servidor como cuerpo de un mensaje (método recomendado).
Obtener - Esta opción adjunta el contenido del formulario de consulta a la URL.
Limitaciones
Cuadros de texto de Approach con cálculos
Los cuadros de texto de Approach que contengan cálculos no podrán convertirse. Los comentarios HTML se agregarán en la posición donde debería estar el cuadro de texto calculado.
Los campos calculados son traducidos por el formulario de consulta, pero no pueden utilizarse.
Las columnas calculadas en los informes quedarán en blanco.
Campos
Utilice los operadores apropiados (>, <, =, etc...) para los campos que no sean de tipo carácter de las consultas. Por ejemplo, especifique ">10" para un campo de tipo entero. Los campos de tipo carácter deben consultarse utilizando la sintaxis PARECIDAS '%criterios%', donde "criterios" representa la cadena incluida en el campo.
Imágenes
Las etiquetas HTML para las imágenes de formularios e informes de Approach se ubican en el archivo de macros *.D2W. El nombre que se asigna a la imagen es el mismo que el nombre del objeto, con extensión .GIF. Para determinar el nombre del objeto de una imagen, cambie al modo Diseño en la vista que contenga el objeto, selecciónelo haciendo doble clic en él acceda a la pestaña Macros en el cuadro de información.
Dibujos y objetos misceláneos en encabezados y pies de página del informe
No se admiten en esta versión del Asistente.
Color de fondo del informe
Si se muestra la sentencia de SQL, no se mostrará el color de fondo de los informes (consulte la opción Visualización SQL). DB2WWW agregará la citada sentencia de SQL al principio del documento HTML, antes de la etiqueta del cuerpo, lo cual impedirá que se muestre el color. En su lugar, se mostrará el color predeterminado del navegador.
Alias de tablas
El Asistente para adaptar DB2 de Approach a Web no admite alias de tablas. Los alias de tablas se utilizan cuando se une una tabla a sí misma. El Asistente admite uniones entre diferentes tablas.